home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d27 / clnup200.arc / CLEANUP.DOC < prev    next >
Text File  |  1991-02-02  |  55KB  |  2,113 lines
  1.  
  2.  
  3.      CleanUp Version 2.00      Jan 27, 1990                     Page 1
  4.  
  5.  
  6.  
  7.      1   PURPOSE
  8.  
  9.      CleanUp is a program designed to help you keep your disk clean of all
  10.      the temporary, backup and other miscellaneous files that accumulate
  11.      during normal processing.  CleanUp can delete these files or process
  12.      them with any command you choose.  CleanUp can also run commands on
  13.      each disk and sub-directory to automate your maintenance.
  14.  
  15.      CleanUp uses file specifications that you enter into a control file to
  16.      search all the sub-directories on your hard disk for files to process.
  17.      You can have CleanUp process the files it finds automatically or
  18.      prompt you before processing the file. Any number of specifications
  19.      can be entered and any number of sub-directories can be searched
  20.      (subject to the amount of memory you have available).
  21.  
  22.      CleanUp can be run in "interactive" mode or from a batch file in
  23.      "automatic" mode for use during unattended maintenance.
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      Copyright Bob Breedlove 1989,90               All rights reserved
  65.  
  66.  
  67.  
  68.  
  69.      CleanUp Version 2.00      Jan 27, 1990                     Page 2
  70.  
  71.  
  72.  
  73.      2   REGISTRATION
  74.  
  75.      CleanUp is copyright (c) Bob Breedlove, 1989, 1990. All rights are
  76.      reserved. It is NOT free software. Should you continue to use CleanUp,
  77.      please send $10 registration along with your name, address and
  78.      telephone number to:
  79.  
  80.           Bob Breedlove
  81.           3196 Swallowsnest Dr.
  82.           Sacramento, CA 95833
  83.  
  84.      You can use the registration form at the end of this documentation if
  85.      you wish.  Sorry, registration by phone or credit card not available.
  86.  
  87.      You may use CleanUp on any number of computers that YOU, PERSONALLY
  88.      USE.  If you are registering CleanUp for a company, you MUST register
  89.      CleanUp for each workstation or send a $100.00 site license fee to
  90.      allow you to use any number of copies of CleanUp at your SINGLE SITE.
  91.  
  92.      CleanUp may NOT be distributed with other software or as part of any
  93.      other package.  If you distribute shareware diskettes for money, you
  94.      MUST obtain written permission from the author before distributing
  95.      CleanUp.
  96.  
  97.      Because of the nature of CleanUp and available time, only registered
  98.      users will qualify for support.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.      Copyright Bob Breedlove 1989,90               All rights reserved
  131.  
  132.  
  133.  
  134.  
  135.      CleanUp Version 2.00      Jan 27, 1990                     Page 3
  136.  
  137.  
  138.  
  139.      3   WARRANTY
  140.  
  141.      CleanUp has been tested as thoroughly as possible. However, there is
  142.      no guarantee, either stated or implied that it is suitable for your
  143.      specific use or with your specific equipment. The author, Bob
  144.      Breedlove, cannot be held responsible for any damage or loss of data
  145.      resulting either directly or indirectly from the use of CleanUp.
  146.  
  147.      BEFORE RUNNING CleanUp FOR THE FIRST TIME, BE SURE TO BACKUP ALL
  148.      CRITICAL FILES ON YOUR HARD DISK(S).  This is especially important
  149.      when you first set up your control file.
  150.  
  151.      If you are a registered CleanUp user, you will receive telephone and
  152.      mail support for the product.  In addition, you will be set up with an
  153.      account on BOBsBBS for on-line support.  
  154.  
  155.      NON-REGISTERED USERS CANNOT RECEIVE SUPPORT FOR PROBLEMS WITH CleanUp
  156.      AND THEIR SPECIFIC EQUIPMENT.
  157.  
  158.  
  159.      4   A WARNING!
  160.  
  161.      CleanUp has the potential to completely DESTROY your disk.  PLEASE
  162.      take the precaution of backing up your disk BEFORE you use CleanUp. 
  163.      This is especially important when you first set up a CleanUp control
  164.      file.
  165.  
  166.  
  167.      5   NETWORK DISKS
  168.  
  169.      CleanUp should work on network disks with some exceptions.  CleanUp
  170.      has to have access to the sub-directories on your network disks.  If
  171.      CleanUp cannot get access to the root directory ({drive}:\) then it
  172.      cannot process the disk because it cannot construct a list of
  173.      sub-directories to process.  This situation can happen if the root
  174.      directory on your hard disk is protected from access.
  175.  
  176.      CleanUp SHOULD process disks correctly if some of the sub-directories
  177.      (other than the root) are protected from access.  The protected
  178.      directories and their sub-directories will NOT be processed.
  179.  
  180.      Since I do not have access to a network, I cannot test these features
  181.      of CleanUp.  If you register the software and have problems running it
  182.      on your network, I will work with you.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.      Copyright Bob Breedlove 1989,90               All rights reserved
  197.  
  198.  
  199.  
  200.  
  201.      CleanUp Version 2.00      Jan 27, 1990                     Page 4
  202.  
  203.  
  204.  
  205.      6   FILES
  206.  
  207.      The following files should be on the CleanUp diskette or in the
  208.      archive file that you received:
  209.  
  210.           CleanUp.EXE    The CleanUp Program
  211.           CleanUp.CTL    A sample control file.
  212.           CleanUp.DOC    This documentation
  213.           EDITOR.CMD     A "cheat sheet" of editor commands.
  214.           READ.ME        Additional comments, new features
  215.  
  216.      NOTE: The READ.ME file will ONLY be included when there is additional
  217.      information about the current release of CleanUp or other BOBsWARE
  218.      products which is not included in the documentation (CleanUp.DOC).
  219.  
  220.      If you received these files from a bulletin board system and the file
  221.      is not complete or contains other files, BE VERY CAUTIOUS!  The
  222.      program may have been tampered with.
  223.  
  224.      The only files necessary to run CleanUp are CleanUp.EXE and
  225.      CleanUp.CTL or other control file.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.      Copyright Bob Breedlove 1989,90               All rights reserved
  263.  
  264.  
  265.  
  266.  
  267.      CleanUp Version 2.00      Jan 27, 1990                     Page 5
  268.  
  269.  
  270.  
  271.      7   Starting CleanUp
  272.  
  273.      7.1  Introduction
  274.  
  275.      Before you can run CleanUp, you must create a control file --
  276.      default "CleanUp.CTL".  See the section -- The Control File --
  277.      for details on creating CleanUp.CTL.
  278.  
  279.      CleanUp.EXE and the control file are the only files required to
  280.      run CleanUp. They can be placed anywhere on your path. If you are
  281.      unfamiliar with the DOS PATH command, please refer to your DOS
  282.      documentation.
  283.  
  284.  
  285.      7.2  The CleanUp Command Line
  286.  
  287.      To run CleanUp, use the following command line:
  288.  
  289.           CleanUp [[{path}]{ControlFileName}] [{switches}]
  290.  
  291.      {ControlFileName} is the name of the control file you wish to
  292.      use. If you do NOT enter the control file name, CleanUp will use
  293.      "CleanUp.CTL".  If you do not enter an extension CleanUp will use
  294.      the default extension "CTL".
  295.  
  296.      If you specify a complete path name for the control file, CleanUp
  297.      will search ONLY that directory. If you specify ONLY a filename
  298.      or do NOT specify the control file name, CleanUp will search the
  299.      current directory first. The current directory is the one that
  300.      you were in when you started CleanUp. If it can not find the
  301.      control file, CleanUp will search the DOS PATH for the file.
  302.  
  303.      If CleanUp cannot find the control file and you have NOT
  304.      specified any switches, CleanUp will abort.
  305.  
  306.      The following switches can be entered on the command line:
  307.  
  308.      /E  Edit the specified control file (or CleanUp.CTL if none is
  309.          specified) and then exit the program WITHOUT processing the
  310.          specified patterns and commands.
  311.  
  312.      /R  Edit the specified control file (or CleanUp.CTL if none is
  313.          specified) and then process the specified patterns and commands.
  314.  
  315.      If either switch is specified, CleanUp will create a new control file
  316.      if it can't find the one specified.
  317.  
  318.      NOTE: you can NOT enter a path name without the control filename. 
  319.      CleanUp will think that the last sub-directory in your path is the
  320.      control file and attempt to find that file.  For example:
  321.  
  322.           C:\BIN\CleanUp.CTL
  323.  
  324.      is valid, but
  325.  
  326.  
  327.  
  328.      Copyright Bob Breedlove 1989,90               All rights reserved
  329.  
  330.  
  331.  
  332.  
  333.      CleanUp Version 2.00      Jan 27, 1990                     Page 6
  334.  
  335.  
  336.  
  337.  
  338.           C:\BIN
  339.  
  340.      is NOT. CleanUp will search for a file named "BIN.CTL" in the root
  341.      directory on the C: drive.
  342.  
  343.  
  344.      7.3  Examples
  345.  
  346.      C> CleanUp
  347.  
  348.      CleanUp will search for "CleanUp.CTL" in the current directory.
  349.      If it is not found, it will search for a control file with this
  350.      name along the DOS path.  If "CleanUp.CTL" is not found, the
  351.      program will terminate with an error message.
  352.  
  353.  
  354.      C> CleanUp Weekly.CTL
  355.  
  356.      CleanUp will search for the control file "Weekly.CTL" in the
  357.      current directory and along the path. It will terminate with an
  358.      error if the file is not found. This control file may be one of
  359.      many. Naming control files like this allows you to have one
  360.      control file for daily processing and another for weekly or
  361.      special processing.
  362.  
  363.  
  364.      C> CleanUp Weekly
  365.  
  366.      This is the equivalent of the command above.  CleanUp will use
  367.      the control file "WEEKLY.CTL".
  368.  
  369.      NOTE: if you wish to use a control file without an extension, you
  370.      must enter the filename followed by a period.  For example, to
  371.      use the control name "WEEKLY", enter "CleanUp WEEKLY.".
  372.                                               Note period^
  373.  
  374.  
  375.      C> CleanUp /E
  376.  
  377.      This version of the command line is used to edit CleanUp.CTL and
  378.      then terminate the program.  CleanUp will still search for
  379.      "CleanUp.CTL" in the current directory and along the path.
  380.      However, if it does not find an existing "CleanUp.CTL", it will
  381.      create one IN THE CURRENT DIRECTORY.
  382.  
  383.      When CleanUp starts you are placed in the full-screen editor.
  384.      When you exit the editor, CleanUp terminates.
  385.  
  386.      Equivalent lines are:
  387.  
  388.           C> CleanUp CleanUp /e
  389.           C> CleanUp CleanUp.CTL /e
  390.  
  391.  
  392.  
  393.  
  394.      Copyright Bob Breedlove 1989,90               All rights reserved
  395.  
  396.  
  397.  
  398.  
  399.      CleanUp Version 2.00      Jan 27, 1990                     Page 7
  400.  
  401.  
  402.  
  403.      C> CleanUp /R
  404.  
  405.      This example is identical to that above ("CleanUp /E") with the
  406.      exception that CleanUp will process the control file instructions
  407.      once you have exited the editor.
  408.  
  409.  
  410.      C> CleanUp D:\UTILITY\CleanUp.CTL
  411.  
  412.      When you enter the full path name, CleanUp searches for the file
  413.      in the specified directory only. In this case, if CleanUp does
  414.      not find "CleanUp.CTL" in the directory "D:\UTILITY", it will
  415.      terminate with an error message. This feature allows you to
  416.      create control files with the same name in different directories
  417.      and process them as desired.
  418.  
  419.  
  420.      C> CleanUp C:\BIN\Daily.CTL /R
  421.  
  422.      CleanUp will search the directory "C:\BIN" for a control file
  423.      called "Daily.CTL". If it does not find one, it will create one
  424.      in "C:\BIN". CleanUp will put you in the editor to edit/create
  425.      the file and then execute the resulting control file. 
  426.  
  427.  
  428.      C> CleanUp C:\BIN\Daily.CTL /E
  429.  
  430.      This example is identical to the one above except that CleanUp
  431.      will NOT execute the instructions in "Daily.CTL" once you exit
  432.      the editor.
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.      Copyright Bob Breedlove 1989,90               All rights reserved
  461.  
  462.  
  463.  
  464.  
  465.      CleanUp Version 2.00      Jan 27, 1990                     Page 8
  466.  
  467.  
  468.  
  469.      8   The CONTROL FILE (CleanUp.CTL)
  470.  
  471.      8.1  Introduction
  472.  
  473.      CleanUp's control file(s) is a plain MS-DOS ASCII text file. It
  474.      can be created using any text editor or word processor that does
  475.      NOT introduce format characters into the text. The easiest way to
  476.      create or modify CleanUp.CTL is to use CleanUp's built-in
  477.      full-screen text editor.
  478.  
  479.  
  480.      8.2  Format
  481.  
  482.      The CleanUp control file consists of lines in one of the
  483.      following formats:
  484.  
  485.      {session switch}
  486.      {disk/directory commands}
  487.      {filename pattern} [{switches}] [{command}]
  488.  
  489.      {session switch} is a command switch which affects the entire
  490.      CleanUp Process. {switches} which appear on the same line as a
  491.      {filename pattern} affect files matching that pattern ONLY. 
  492.      {disk/directory commands} are commands executed while processing
  493.      disks and directories.
  494.  
  495.      NOTE: Only ONE filename pattern per command line is allowed.
  496.  
  497.      Future versions of CleanUp may add features, however, they will
  498.      be downward compatible with existing command files.
  499.  
  500.  
  501.      8.3  Session Switches
  502.  
  503.      Session switches are placed one per command line. They affect the
  504.      entire CleanUp session.
  505.  
  506.  
  507.      8.3.1  /B (Batch Operation)
  508.  
  509.      When the /B session switch is detected, CleanUp will NOT pause
  510.      after completing execution. This is useful if you wish to run
  511.      CleanUp in unattended mode from a batch file.
  512.  
  513.  
  514.      8.3.2  /D (Disks to Process)
  515.  
  516.      This switch tells CleanUp which disks to process. If it is not
  517.      found, CleanUp will process the current disk.  You can list any
  518.      number of disks after the switch.  The format of this line is:
  519.  
  520.      /D {disk list}
  521.  
  522.  
  523.  
  524.  
  525.  
  526.      Copyright Bob Breedlove 1989,90               All rights reserved
  527.  
  528.  
  529.  
  530.  
  531.      CleanUp Version 2.00      Jan 27, 1990                     Page 9
  532.  
  533.  
  534.  
  535.      The {disk list} is in the format of single letters. Do NOT leave
  536.      a space between the letters.  For example:
  537.  
  538.      /D CD
  539.  
  540.      would process disks C: and D:
  541.  
  542.      /D CDEFG
  543.  
  544.      would process disks C: through G:
  545.  
  546.      /D CDG
  547.  
  548.      would process disks C:, D:, and G: only
  549.  
  550.      NOTE: CleanUp does NOT check to be sure that there are disks in
  551.      removable media disk drives.  Be sure that you have set up all disks
  552.      before starting CleanUp.
  553.  
  554.  
  555.      8.4  DOS Commands
  556.  
  557.      CleanUp can execute a DOS command, program or batch file at the
  558.      following times during processing:
  559.  
  560.      o   Just before processing a disk
  561.      o   Just after processing a disk
  562.      o   Just before processing a sub-directory
  563.      o   Just after processing a sub-directory
  564.  
  565.      You may specify a single command for each situation.
  566.  
  567.      (NOTE: CleanUp will execute a command in place of deleting specific
  568.      filename patterns.  This capability is discussed in the section on
  569.      filename patterns.)
  570.  
  571.      The DOS command must be enclosed in quote marks (") when it contains a
  572.      space. The general format for these commands is:
  573.  
  574.      /{D|S|P}{+|-} [sub-directory (/P only)] ["]{command}["]
  575.  
  576.      {Command} is executed in a window.  Some programs may over-write this
  577.      window, however, most DOS commands will execute properly in the
  578.      window.  CleanUp has been tested with most DOS commands, however,
  579.      there is no guarantee that CleanUp can execute a specific program.
  580.  
  581.      The following paragraphs describe each of the command lines.
  582.  
  583.  
  584.      8.4.1  Command Substitutions
  585.  
  586.      When executing a command, CleanUp will perform  substitutions. 
  587.      These are discussed below.  In these discussions, the following
  588.      conditions exist for the examples:
  589.  
  590.  
  591.  
  592.      Copyright Bob Breedlove 1989,90               All rights reserved
  593.  
  594.  
  595.  
  596.  
  597.      CleanUp Version 2.00      Jan 27, 1990                    Page 10
  598.  
  599.  
  600.  
  601.  
  602.      Current Disk:            C:
  603.      Current Sub-Directory:   C:\BIN
  604.      Current Filename:        TEST.BAK
  605.      Current Pattern:         *.BAK
  606.  
  607.  
  608.      %D - Current Disk
  609.  
  610.      Substitutes the drive LETTER only from the current drive. For
  611.      example, the command line:
  612.  
  613.           /D+ "SCAN %D:"
  614.  
  615.      would result in CleanUp executing
  616.  
  617.           SCAN C:
  618.  
  619.      When the C: drive is first accessed.
  620.  
  621.  
  622.      %S - Current Sub-directory
  623.  
  624.      Substitutes the current sub-directory path.  For example:
  625.  
  626.           /S+ "CATALOG %S"
  627.  
  628.      would execute
  629.  
  630.           CATALOG C:\BIN
  631.  
  632.      when starting the C:\BIN directory.
  633.  
  634.  
  635.      %F - Current Filename
  636.  
  637.      Substitutes the current filename and extension in the DOS
  638.      command.  For example:
  639.  
  640.           *.BAK "COPY $F C:\WORK"
  641.  
  642.      would cause CleanUp to execute:
  643.  
  644.           COPY TEST.BAK C:\WORK
  645.  
  646.      when TEST.BAK was processed instead of deleting the file.
  647.  
  648.  
  649.      %N - Current Filename--Name Only
  650.  
  651.      Substitutes ONLY the filename (no extension) in the command. For
  652.      example:
  653.  
  654.           *.BAK "COPY %F %N.HLD"
  655.  
  656.  
  657.  
  658.      Copyright Bob Breedlove 1989,90               All rights reserved
  659.  
  660.  
  661.  
  662.  
  663.      CleanUp Version 2.00      Jan 27, 1990                    Page 11
  664.  
  665.  
  666.  
  667.  
  668.      would result in the command:
  669.  
  670.           COPY TEST.BAK TEST.HLD
  671.  
  672.      being executed when TEST.BAK was processed instead of deleting
  673.      the file.
  674.  
  675.  
  676.      %E - Current Filename--Extension Only
  677.  
  678.      Substitutes the file extension only (no filename).  For example:
  679.  
  680.           *.BAK "MAINTAIN %N %E"
  681.  
  682.      would pass the filename and extension to the batch file
  683.      MAINTAIN.BAT by executing the command line:
  684.  
  685.           MAINTAIN TEST BAK
  686.  
  687.  
  688.      %P - Current File Pattern
  689.  
  690.      Substitutes the current file pattern in the DOS command.  For
  691.      example:
  692.  
  693.           *.BAK "MAINTAIN %P"
  694.  
  695.      would pass the file pattern to MAINTAIN.BAT by executing
  696.  
  697.           MAINTAIN *.BAK
  698.  
  699.  
  700.      8.4.2  Disk/Directory Commands
  701.  
  702.      8.4.2.1  Introduction
  703.  
  704.      This set of commands affects how CleanUp processes disks and
  705.      sub-directories.  DOS commands can be executed before a
  706.      disk/directory is processed ("+") or after a disk/directory has
  707.      been processed ("-").
  708.  
  709.      For example, the command line:
  710.  
  711.           /D+ "SCAN %D:"
  712.  
  713.      would execute the program SCAN.EXE BEFORE CleanUp processed the
  714.      sub-directories on each disk.  The line:
  715.  
  716.           /D- "CATALOG %D:"
  717.  
  718.      would run the program CATALOG.EXE AFTER CleanUp had completed
  719.      processing all the sub-directories on a disk.
  720.  
  721.  
  722.  
  723.  
  724.      Copyright Bob Breedlove 1989,90               All rights reserved
  725.  
  726.  
  727.  
  728.  
  729.      CleanUp Version 2.00      Jan 27, 1990                    Page 12
  730.  
  731.  
  732.  
  733.      A single command will be executed when entering and leaving each
  734.      disk and sub-directory.  If multiple "/D[+|-]" or "/S[+|-]"
  735.      commands are entered, only the LAST one will be executed.  If you
  736.      wish to execute multiple commands, place them in a batch file and
  737.      have CleanUp execute that.
  738.  
  739.  
  740.      8.4.2.2  Naming Sub-Directories
  741.  
  742.      Sub-directories on the /X and /P commands must be entered with
  743.      their full disk/directory names.  For example:
  744.  
  745.           /X C:\BIN
  746.  
  747.      or
  748.  
  749.           /P+ C:\WORK "CATALOG %S"
  750.  
  751.      are correct.  However,
  752.  
  753.           /X \BIN
  754.  
  755.      is NOT correct because it does not include the drive ("C:").  The
  756.      full disk and directory name is required because you may have
  757.      duplicate sub-directory names on different directories.  If only
  758.      sub-directory names are considered, CleanUp may process these
  759.      sub-directories incorrectly.
  760.  
  761.  
  762.      8.4.2.3  /D[+|-] (Disk Commands)
  763.  
  764.      Format:
  765.  
  766.           /D[+|-] ["]{DOS Command}["]
  767.  
  768.      This command specifies a DOS command to be executed before ("+")
  769.      or after ("-") CleanUp processes each disk.
  770.  
  771.      Examples:
  772.  
  773.           /D+ "SCAN %D:"
  774.           /D- "CATALOG"
  775.  
  776.  
  777.      8.4.2.4  /S[+|-] (General Sub-Directory Commands)
  778.  
  779.      Format:
  780.  
  781.           /S[+|-] ["]{DOS Command}["]
  782.  
  783.      This command will be executed before ("+") or after ("-") CleanUp
  784.      processes each directory unless it is overridden by a /P command.
  785.  
  786.      Examples:
  787.  
  788.  
  789.  
  790.      Copyright Bob Breedlove 1989,90               All rights reserved
  791.  
  792.  
  793.  
  794.  
  795.      CleanUp Version 2.00      Jan 27, 1990                    Page 13
  796.  
  797.  
  798.  
  799.  
  800.           /S+ "MAINTAIN.BAT"
  801.           /S- "DOIT %S"
  802.  
  803.  
  804.      8.4.2.5  /P[+|-] (Specific Sub-Directory Commands)
  805.  
  806.      Format:
  807.  
  808.           /P[+|-] {directory} ["]{DOS Command}["]
  809.  
  810.      Allows you to specify a command that will be executed before
  811.      ("+") or after ("-") CleanUp processes the specified directory
  812.      ONLY.  NOTE: This command is executed INSTEAD of the
  813.      corresponding /S command for the specified directory.
  814.  
  815.      Examples:
  816.  
  817.           /P+ C:\BIN "SCAN %S"
  818.           /P- C:\WORK\TEST "SPECIAL.BAT"
  819.  
  820.  
  821.      8.4.2.6  /X (Exclude Sub-directory)
  822.  
  823.      Format:
  824.  
  825.           /X {directory}
  826.  
  827.      Specifies that the named directory is to be excluded from
  828.      processing.  NO processing will be done on this directory.
  829.  
  830.      Examples:
  831.  
  832.           /X C:\HOLD
  833.           /X D:\WORK\SPECIAL
  834.           /X E:\UPLOAD
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.      Copyright Bob Breedlove 1989,90               All rights reserved
  857.  
  858.  
  859.  
  860.  
  861.      CleanUp Version 2.00      Jan 27, 1990                    Page 14
  862.  
  863.  
  864.  
  865.      8.5  Filename Patterns
  866.  
  867.      CleanUp uses an extended set of file name matching symbols
  868.      (Templates). These allow greater flexibility in the selection of
  869.      files to be processed than the standard DOS wildcard characters
  870.      ("?" and "*"). Only a single filename pattern can be placed on
  871.      each line.
  872.  
  873.  
  874.      8.5.1  File Pattern Line
  875.  
  876.  
  877.  
  878.      8.5.2  Template Summary
  879.  
  880.      The following is a summary of template characters that can be used in
  881.      filename patterns:
  882.  
  883.          ?   = Any character
  884.          #   = Any integer
  885.          @   = Any alphabetic character
  886.          *   = any string of zero or more characters
  887.          []  = Groups characters inclusive
  888.          [~] = Groups characters exclusive
  889.          {|} = Groups of phrases
  890.  
  891.      Each of these template characters is described in detail below.
  892.  
  893.  
  894.      8.5.3  Template Characters
  895.  
  896.      ?   [Any Character]
  897.  
  898.      Just as the DOS wildcard character, the question mark ("?")
  899.      matches any SINGLE character.  The exact number of characters
  900.      represented by the "?" must be present to match.
  901.  
  902.      Examples:
  903.  
  904.      ???.EXE                       Matches any file with EXACTLY 3
  905.                                    characters and an extension of EXE. For
  906.                                    example: ABC.EXE, 123.EXE, A2_.EXE. It
  907.                                    would not match AB.EXE or ABCD.EXE.
  908.  
  909.      TEST?.DOC                     Matches any file with a filename that
  910.                                    consists of "TEST" followed by any
  911.                                    SINGLE character and has an extension of
  912.                                    "DOC". It would match TEST1.DOC or
  913.                                    TESTM.DOC, but NOT TEST12.DOC or
  914.                                    TEST.DOC.
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.      Copyright Bob Breedlove 1989,90               All rights reserved
  923.  
  924.  
  925.  
  926.  
  927.      CleanUp Version 2.00      Jan 27, 1990                    Page 15
  928.  
  929.  
  930.  
  931.      TEST.???                      Matches any file whose name is TEST with
  932.                                    a three character extension. Would match
  933.                                    TEST.EXE and TEST.DOC, but would NOT
  934.                                    match TEST.1 or TEST2.DOC.
  935.  
  936.  
  937.      #   [Any Integer]
  938.  
  939.      This template character is the same as the "?" except that it
  940.      only matches the numbers 0,1,2,3,4,5,6,7,8,9.
  941.  
  942.      EXAMPLES:
  943.  
  944.      A###.TXT                      Would match any file name starting with
  945.                                    "A" followed by three numbers and having
  946.                                    the extension "TXT".  It would match
  947.                                    "A123.TXT" and "A989.TXT", but not
  948.                                    "ABCD.TXT", "A1.TXT" or "A22A.TXT".
  949.  
  950.      #*.*                          Would match any file whose name started
  951.                                    with a number.
  952.  
  953.  
  954.      @   [Any Alphabetic Character]
  955.  
  956.      This template character is the same as the "?" except that it
  957.      matches only the alphabetic characters A-Z. Case is ignored.
  958.  
  959.      Examples:
  960.  
  961.      @???.@@@                      Would match any file whose name was
  962.                                    exactly 4 characters long and started
  963.                                    with any alphabetic character and whose
  964.                                    extension was composed of exactly three
  965.                                    alphabetic characters.  It would match
  966.                                    "A123.ABC" or "ZA2C.TXT", but not
  967.                                    "5ABC.TXT" or "A123.A2C".
  968.  
  969.      T@#*.*                        Would match any file whose name started
  970.                                    with a "T" followed by any alphabetic
  971.                                    character and any numeric character.
  972.  
  973.  
  974.      *   [Any string of zero or more Characters]
  975.  
  976.      The asterisk ("*") matches any string of zero or more characters.
  977.      NOTE: Unlike the DOS "*" this template character can be used
  978.      anywhere in the file name or extension.
  979.  
  980.      *.EXE                         Matches any file with the extension
  981.                                    "EXE".
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.      Copyright Bob Breedlove 1989,90               All rights reserved
  989.  
  990.  
  991.  
  992.  
  993.      CleanUp Version 2.00      Jan 27, 1990                    Page 16
  994.  
  995.  
  996.  
  997.      TEST*.DOC                     Matches any file which starts with
  998.                                    "TEST" and has zero or more characters
  999.                                    in the remainder of the filename and has
  1000.                                    the extension "DOC". This template would
  1001.                                    match TEST.DOC, TEST1.DOC, TESTABC.DOC.
  1002.  
  1003.      *TEST.*                       This template would match any file with
  1004.                                    TEST as the last four characters of the
  1005.                                    filename and any extension. It would
  1006.                                    match TEST.DOC, ATEST.EXE, THISTEST.TXT.
  1007.                                    It would not match TEST1.DOC.
  1008.  
  1009.      T*0*.T*                       This pattern matches any file that
  1010.                                    starts with "T", has a "0" somewhere in
  1011.                                    the filename and has an extension that
  1012.                                    starts with "T". It matches T10.TXT,
  1013.                                    T011.T, TXXXXXX0.T00. It would not match
  1014.                                    T111.TXT, 1T0.T, T00.XXX.
  1015.  
  1016.      CAUTION:  As with DOS, the "*" can be VERY dangerous.  For example,
  1017.      "*.*" would delete ALL the files from your disk.
  1018.  
  1019.  
  1020.      []  [Groups characters, inclusive]
  1021.      [~] [Groups characters, exclusive]
  1022.  
  1023.      The "[]" pattern allows you to specify characters which are to be
  1024.      considered in an "or" function.  The [~] pattern indicates that
  1025.      the character must NOT be one of the characters.  The "-" is used
  1026.      to indicate a range of characters.  The "," indicates separate
  1027.      characters.  All characters within the "[]" have their literal
  1028.      meaning.
  1029.  
  1030.      Examples:
  1031.  
  1032.      [a-e]*.*                      Will match any filename starting with
  1033.                                    the characters "a","b","c","d", or "e". 
  1034.                                    It would match ATEST.DOC or DONE.TXT,
  1035.                                    but not FRED.DOC.
  1036.  
  1037.      [a,d,1,@]*.*                  Will match any filename starting with
  1038.                                    the characters "a","d","1" or "@". 
  1039.                                    Notice that the "@" does NOT have its
  1040.                                    meaning in a template.
  1041.  
  1042.      S[a-d,g,1-3]*.123             Will match any filename starting with
  1043.                                    the letter "S" and followed by one of
  1044.                                    the characters
  1045.                                    "a","b","c","d","g","1","2","3" and
  1046.                                    having the extension "123".
  1047.  
  1048.      [~a-z]*.*                     Will match any filename NOT starting
  1049.                                    with an alphabetic character.
  1050.  
  1051.  
  1052.  
  1053.  
  1054.      Copyright Bob Breedlove 1989,90               All rights reserved
  1055.  
  1056.  
  1057.  
  1058.  
  1059.      CleanUp Version 2.00      Jan 27, 1990                    Page 17
  1060.  
  1061.  
  1062.  
  1063.      [~a,1,@]*.*                   Will match any filename NOT starting
  1064.                                    with an "a","1", or "@".
  1065.  
  1066.  
  1067.      {|} [Groups phrases]
  1068.  
  1069.      Just as the "[]" pattern matches single characters, the "{|}"
  1070.      pattern matches sets of one or more phrases.  The vertical bar
  1071.      "|" is used to separate the phrases.  The phrases to not have to
  1072.      be the same length.
  1073.  
  1074.      Examples:
  1075.  
  1076.      {TO|THE|T2A}*.*               Will match filenames starting with "TO",
  1077.                                    "THE", or "T2A".
  1078.  
  1079.      *{XA|XB|TC}.*                 Will match filenames ending with "XA",
  1080.                                    "XB", or "TC".
  1081.  
  1082.      *.{TMP|TST}                   Will match filenames with the extensions
  1083.                                    "TMP" or "TST".
  1084.  
  1085.      *{T1|T2|A1|A2}*.*             Will match filenames with the phrases
  1086.                                    "T1", "T2", "A1" or "A2" somewhere in
  1087.                                    their filenames. NOTE, this could also
  1088.                                    be entered as "*[A,T][1,2]*.*".
  1089.  
  1090.  
  1091.      8.6  Pattern Options
  1092.  
  1093.      Pattern switches apply only to the pattern on the line in which
  1094.      they are entered.  The following switches are recognized:
  1095.  
  1096.  
  1097.      8.6.1  /V - Verify before processing
  1098.  
  1099.      The (V)erify switch causes CleanUp to pause and prompt you before
  1100.      processing a file which matches this pattern.  A message is
  1101.      displayed in the {message area} and the program pauses for input
  1102.      from the user.  If you answer "Y", the file will be processed. 
  1103.      If you answer "N", it will not be processed.
  1104.  
  1105.  
  1106.      8.6.2  /L - Log file switch
  1107.  
  1108.      The (L)og switch causes CleanUp to record the individual filename
  1109.      in the log file.  This gives you a permanent record of which
  1110.      files were processed.
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.      Copyright Bob Breedlove 1989,90               All rights reserved
  1121.  
  1122.  
  1123.  
  1124.  
  1125.      CleanUp Version 2.00      Jan 27, 1990                    Page 18
  1126.  
  1127.  
  1128.  
  1129.      8.6.3  /C - Count only switch
  1130.  
  1131.      The (C)ount switch causes CleanUp to tally the file, but NOT
  1132.      process it.  This can be useful if you wish only to know how many
  1133.      of a particular file are on your hard disk.  It is also useful
  1134.      for testing complex patterns to make sure that they process ONLY
  1135.      the files that you intend.
  1136.  
  1137.  
  1138.      8.6.4  "{DOS Command}"
  1139.  
  1140.      A DOS command can be executed instead of deleting the file.  This
  1141.      command must be the LAST thing on the pattern line and MUST be
  1142.      enclosed in quotes if the DOS command contains spaces.  For
  1143.      example:
  1144.  
  1145.           *.BAK "COPY %F C:\WORK\%N.OLD"
  1146.           *.TMP /V "MAINTAIN %N %E"
  1147.           *.OLD /V/L "MYBAT %F"
  1148.  
  1149.      are all valid command lines.  However,
  1150.  
  1151.           *.BAK "COPY %F C:\WORK\%N.OLD" /V
  1152.           *.TMP /V MAINTAIN %F
  1153.  
  1154.      are NOT valid.
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.      Copyright Bob Breedlove 1989,90               All rights reserved
  1187.  
  1188.  
  1189.  
  1190.  
  1191.      CleanUp Version 2.00      Jan 27, 1990                    Page 19
  1192.  
  1193.  
  1194.  
  1195.      9   The CleanUp Screen
  1196.  
  1197.      +---------------------------------------------------------------+
  1198.      | Directory: {directory}                                        |
  1199.      +-----------------------------+---------------------------------+
  1200.      |{processed files}            | Disks       Processed : {count} |
  1201.      |                             | Directories Processed : {count} |
  1202.      |                             | Files Read            : {count} |
  1203.      |                             | Files Matched         : {count} |
  1204.      |                             | Files Deleted         : {count} |
  1205.      |                             +---------------------------------+
  1206.      |                             |{control file name}              |
  1207.      |                             +---------------------------------+
  1208.      |                             |{control file patterns}          |
  1209.      |                             |{final statistics}               |
  1210.      |                             |                                 |
  1211.      |                             |                                 |
  1212.      |                             |                                 |
  1213.      |                             |                                 |
  1214.      |                             |                                 |
  1215.      |                             |                                 |
  1216.      |                             |                                 |
  1217.      +-----------------------------+                                 |
  1218.      |{messages and prompts}       |                                 |
  1219.      |                             |                                 |
  1220.      +-----------------------------+---------------------------------+
  1221.       Cleanup version {version} (c) Bob Breedlove 1989,1990
  1222.  
  1223.  
  1224.      While cleanup is processing, it displays the CleanUp control
  1225.      screen.  This screen displays information about the session.  It
  1226.      is also used to prompt for information from the user, if
  1227.      required.  The following briefly describes each area on the
  1228.      screen.
  1229.  
  1230.      {directory}                   Directory being processed.
  1231.  
  1232.      {processed files}             Lists files as they are
  1233.                                    deleted/processed.
  1234.  
  1235.      {count}                       Lists count of files in category while
  1236.                                    processing.
  1237.  
  1238.      {control file name}           The control file name including path.
  1239.  
  1240.      {control file patterns}
  1241.      {final statistics}            During processing, this section lists
  1242.                                    the control file patterns.  After
  1243.                                    processing is complete, it displays a
  1244.                                    set of final statistics for the session.
  1245.  
  1246.      {messages and prompts}        Displays general messages and prompts
  1247.                                    during processing.
  1248.  
  1249.  
  1250.  
  1251.  
  1252.      Copyright Bob Breedlove 1989,90               All rights reserved
  1253.  
  1254.  
  1255.  
  1256.  
  1257.      CleanUp Version 2.00      Jan 27, 1990                    Page 20
  1258.  
  1259.  
  1260.  
  1261.      For a description of the messages and prompts displayed during
  1262.      processing see the section on "Messages" at the end of this
  1263.      documentation.
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.      Copyright Bob Breedlove 1989,90               All rights reserved
  1319.  
  1320.  
  1321.  
  1322.  
  1323.      CleanUp Version 2.00      Jan 27, 1990                    Page 21
  1324.  
  1325.  
  1326.  
  1327.      10  The log file (CleanUp.LOG)
  1328.  
  1329.      CleanUp maintains a log file.  By default, this file is called
  1330.      CleanUp.LOG.  It is stored in the same sub-directory where
  1331.      CleanUp found the control file.  The file is a plain ASCII text
  1332.      file and can be listed, edited or printed.  The log file name
  1333.      will be the same as the name of the control file used with an
  1334.      extension of "LOG".  For example: if your control file is
  1335.      "DAILY.CTL" then the log file will be "DAILY.LOG".
  1336.  
  1337.      NOTE: CleanUp will write over any existing log files.  If you
  1338.      wish to keep track of previous CleanUp sessions, you will have to
  1339.      rename the log file to a different name or copy the log file to a
  1340.      different directory before running CleanUp.
  1341.  
  1342.  
  1343.      10.1  Sample Log File
  1344.  
  1345.      CleanUp version 2.00  started : 01/20/90 at 12:51:23
  1346.  
  1347.      Control File: 
  1348.  
  1349.      Disks : C
  1350.      *.BAK /L
  1351.      *.TMP /V
  1352.      *.[&,~]*
  1353.      *.??$
  1354.      *.O
  1355.  
  1356.      TEST.BAK     deleted
  1357.      DOCUMENT.BAK deleted
  1358.      RESTORE.BAK  deleted
  1359.  
  1360.  
  1361.                             Num     Bytes      Num    Bytes
  1362.      Pattern              Matched  Matched   Deleted Deleted
  1363.      *.BAK                    3      16835       3     16835
  1364.      *.TMP                    0          0       0         0
  1365.      *.[&,~]*                 0          0       0         0
  1366.      *.??$                    0          0       0         0
  1367.      *.O                      0          0       0         0
  1368.  
  1369.      Disks Processed :         1
  1370.      Dirs  Processed :        43
  1371.      Files Read      :       888
  1372.      Bytes Read      :  17911920
  1373.      Files Matched   :         3
  1374.      Bytes Matched   :     16835
  1375.      Files Deleted   :         3
  1376.      Bytes Deleted   :     16835
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.      Copyright Bob Breedlove 1989,90               All rights reserved
  1385.  
  1386.  
  1387.  
  1388.  
  1389.      CleanUp Version 2.00      Jan 27, 1990                    Page 22
  1390.  
  1391.  
  1392.  
  1393.      10.2  Log File Contents
  1394.  
  1395.      10.2.1  Log File Header
  1396.  
  1397.      The log file header contains the CleanUp version number.  This
  1398.      number is important when reporting problems with your registered
  1399.      version of CleanUp.
  1400.  
  1401.      The header also shows the date and time that CleanUp was run. 
  1402.      These are taken from the computer's clock and will only be as
  1403.      accurate as the clock.
  1404.  
  1405.  
  1406.      10.2.2  CleanUp Control File Patterns
  1407.  
  1408.      CleanUp then displays the control file name and its contents.
  1409.      This section in the log file contains the patterns and control
  1410.      switches found in the control file.
  1411.  
  1412.  
  1413.      10.2.3  File Processing Log
  1414.  
  1415.      If you have told CleanUp to log files that it finds and processes
  1416.      (/L switch), this section contains a list of these filenames.
  1417.  
  1418.  
  1419.      10.2.4  Pattern Counts
  1420.  
  1421.      CleanUp next displays the counts and total bytes matched and
  1422.      processed (deleted) for each of the file patterns.
  1423.  
  1424.  
  1425.      10.2.5  Total Counts
  1426.  
  1427.      The log ends with the total processing count display.  This is
  1428.      the same display which is shown in the lower right-hand window on
  1429.      the CleanUp screen.
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.      Copyright Bob Breedlove 1989,90               All rights reserved
  1451.  
  1452.  
  1453.  
  1454.  
  1455.      CleanUp Version 2.00      Jan 27, 1990                    Page 23
  1456.  
  1457.  
  1458.  
  1459.      11  The Full Screen Editor
  1460.  
  1461.      CleanUp has a full-screen editor which can be used to edit the
  1462.      control file.  It can handle files up to 64K in size.  The editor
  1463.      uses commands very similar to WordStar (tm).  The file EDITOR.CMD
  1464.      contains the commands.  To print this "cheat sheet", you can use
  1465.      the command:
  1466.  
  1467.           COPY EDITOR.CMD PRN
  1468.  
  1469.      Be sure that your printer is on before you issue this command.
  1470.  
  1471.  
  1472.      11.1  Editing the Control File
  1473.  
  1474.      To edit the control file, start CleanUp with the "/E" or "/R"
  1475.      switches.  See the discussion above for more information on these
  1476.      command line switches.
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.      Copyright Bob Breedlove 1989,90               All rights reserved
  1517.  
  1518.  
  1519.  
  1520.  
  1521.      CleanUp Version 2.00      Jan 27, 1990                    Page 24
  1522.  
  1523.  
  1524.  
  1525.      12  Tips and Cautions
  1526.  
  1527.      12.1  The DOS Path
  1528.  
  1529.      Because CleanUp searches first in the current directory and then
  1530.      along the DOS PATH for the control file, you can have multiple
  1531.      control files in different sub-directories for various
  1532.      situations. In fact, you can have different control files with
  1533.      the SAME NAME in different sub-directories.  If you do, however,
  1534.      it is important that you realize where you have started CleanUp
  1535.      and what your DOS path is! UNLESS YOU SPECIFY THE FULL PATH NAME,
  1536.      CleanUp WILL EXECUTE THE FIRST CONTROL FILE IT FINDS THAT MATCHES
  1537.      YOUR COMMAND LINE!
  1538.  
  1539.      For example, given the following sub-directory structure:
  1540.  
  1541.      C:\
  1542.      +----C:\BIN
  1543.      |     CleanUp.CTL
  1544.      +----C:\WORK
  1545.      |     CleanUp.CTL
  1546.      +----C:\TEST
  1547.      |     CleanUp.CTL
  1548.      +----C:\MYDIR
  1549.  
  1550.      and the following DOS path
  1551.  
  1552.           C:\BIN;C:\WORK
  1553.  
  1554.      starting CleanUp from the following directories will use the
  1555.      indicated CleanUp.CTL file:
  1556.  
  1557.      Start Directory               Control File
  1558.      C:\                           C:\BIN\CleanUp.CTL
  1559.      C:\BIN                        C:\BIN\CleanUp.CTL
  1560.      C:\TEST                       C:\TEST\CleanUp.CTL
  1561.      C:\WORK                       C:\WORK\CleanUp.CTL
  1562.      C:\MYDIR                      C:\BIN\CleanUp.CTL
  1563.  
  1564.      Note that even though "C:\WORK\CleanUp.CTL" is along the DOS Path, it
  1565.      will not be used unless specified explicitly or CleanUp is started
  1566.      from that sub-directory.  This is because the path is searched on the
  1567.      order entered and CleanUp will always find "CleanUp.CTL" in the
  1568.      "C:\BIN" directory first and use it.
  1569.  
  1570.  
  1571.      12.2  Filename Patterns
  1572.  
  1573.      CleanUp will process faster and use less memory if you combine
  1574.      patterns.  For example, if you wish to delete all files with
  1575.      extensions of "BAK" and "TMP", you could enter either:
  1576.  
  1577.           *.BAK
  1578.           *.TMP
  1579.  
  1580.  
  1581.  
  1582.      Copyright Bob Breedlove 1989,90               All rights reserved
  1583.  
  1584.  
  1585.  
  1586.  
  1587.      CleanUp Version 2.00      Jan 27, 1990                    Page 25
  1588.  
  1589.  
  1590.  
  1591.  
  1592.      or
  1593.  
  1594.           *.{BAK|TMP}
  1595.  
  1596.      in the control file.  Both will do the job, but the second will
  1597.      use somewhat less memory and will process somewhat faster.  The
  1598.      first command lines will count the file types separately while
  1599.      the second will give you a total count for both types of files.
  1600.  
  1601.      You might also want to process all files starting with the
  1602.      letters "A", "B", or "D".  You could enter:
  1603.  
  1604.           A*.*
  1605.           B*.*
  1606.           D*.*
  1607.  
  1608.      This would count each type of file separately. However, you could
  1609.      also enter:
  1610.  
  1611.           [a,b,d]*.*
  1612.  
  1613.      and get somewhat faster processing.
  1614.  
  1615.  
  1616.      12.3  Using the /C pattern switch
  1617.  
  1618.      When you first test a control file, you might want to use the /C
  1619.      switch to count the files matching the pattern without deleting
  1620.      them.  This will allow you to verify that only the files that you
  1621.      want to process are actually processed by CleanUp.  Once you've
  1622.      seen that the control file works correctly, remove the switch and
  1623.      process the disk.
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.      Copyright Bob Breedlove 1989,90               All rights reserved
  1649.  
  1650.  
  1651.  
  1652.  
  1653.      CleanUp Version 2.00      Jan 27, 1990                    Page 26
  1654.  
  1655.  
  1656.  
  1657.      13  Capacities
  1658.  
  1659.      CleanUp does not limit the number of patterns or sub-directories
  1660.      that you can process.  However, CleanUp does use memory to store
  1661.      "lists" used to process files.  If you have a large number of
  1662.      sub-directories or patterns, and a small amount of memory,
  1663.      CleanUp may not function.  To make more memory available:
  1664.  
  1665.      o   Remove any memory-resident programs
  1666.      o   Remove any menuing programs that are in memory
  1667.  
  1668.      It is highly unlikely that you will run out of memory if you have done
  1669.      these two things.
  1670.  
  1671.  
  1672.      14  Messages
  1673.  
  1674.      This section contains a description of the messages produced by
  1675.      CleanUp during processing.  They are arranged in alphabetical
  1676.      order.
  1677.  
  1678.  
  1679.      Abort Operation (y/N)?
  1680.  
  1681.           This message appears when you have pressed a key during
  1682.           CleanUp operation.  CleanUp pauses when possible and asks if
  1683.           you wish to interrupt processing.  Press "Y" to abort
  1684.           processing.  If you enter "N" or press <Enter>, processing
  1685.           will continue.
  1686.  
  1687.  
  1688.      ABORTED : {Message}
  1689.  
  1690.           CleanUp has aborted for some reason.  {message} describes
  1691.           the reason that CleanUp aborted.
  1692.  
  1693.  
  1694.      Batch Processing
  1695.  
  1696.           Appears in the Log File when you have specified batch
  1697.           processing ("/B").
  1698.  
  1699.  
  1700.      Cannot Get Current Directory!
  1701.  
  1702.           CleanUp is unable to obtain the name of the current
  1703.           directory.  This is a fatal condition.
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.      Copyright Bob Breedlove 1989,90               All rights reserved
  1715.  
  1716.  
  1717.  
  1718.  
  1719.      CleanUp Version 2.00      Jan 27, 1990                    Page 27
  1720.  
  1721.  
  1722.  
  1723.      Cleanup version {Version} (c) Bob Breedlove 1989,90
  1724.  
  1725.           This is the "banner" message for CleanUp.  It appears at the
  1726.           top of the CleanUp control screen.  The important thing on
  1727.           this message is the {version}.  Registered users will need
  1728.           this when calling for support.
  1729.  
  1730.  
  1731.      CleanUp version {Version} started : {date} at {time}
  1732.  
  1733.           Log File Message.  The {date} and {time} are taken from the
  1734.           system clock.  They will only be as accurate as this clock.
  1735.  
  1736.  
  1737.      Control File: unable to open {ControlFileName}
  1738.  
  1739.           Displayed if CleanUp is unable to locate the control file. 
  1740.           {ControlFileName} indicates the name CleanUp was attempting
  1741.           to find.  Check to make sure that you entered the correct
  1742.           name and that this control file is located somewhere on your
  1743.           DOS PATH.
  1744.  
  1745.  
  1746.      Control File: {ControlFileName}
  1747.  
  1748.           Records the name of the control file in the log file.
  1749.  
  1750.  
  1751.      Delete/Process File (Y/N)?
  1752.  
  1753.           Prompt displayed for each file matching a pattern with the
  1754.           "/V" pattern switch.  Press "Y" to delete or process the
  1755.           file, press "N" to skip the file.
  1756.  
  1757.  
  1758.      Dir Com {In|Out} : {Directory} - {Command}
  1759.  
  1760.           This message is recorded in the log file when you have
  1761.           specified a command for a specific directory using
  1762.           "/P[+|-]".
  1763.  
  1764.           {In|Out}                      indicates whether this command was
  1765.                                         executed before ("+") or after
  1766.                                         ("-") processing the directory.
  1767.           {directory}                   the full path name of the
  1768.                                         directory.
  1769.           {command}                     the command line as you entered it.
  1770.  
  1771.  
  1772.      Dir {In|Out} : {Command}
  1773.  
  1774.           Written to the Log File when you specify a command to be
  1775.           executed before ("+") or after ("-") processing each
  1776.           directory ("/S{+|-}").
  1777.  
  1778.  
  1779.  
  1780.      Copyright Bob Breedlove 1989,90               All rights reserved
  1781.  
  1782.  
  1783.  
  1784.  
  1785.      CleanUp Version 2.00      Jan 27, 1990                    Page 28
  1786.  
  1787.  
  1788.  
  1789.      Directory {In|Out} : {command}
  1790.  
  1791.           CleanUp displays the DOS command being executed when you
  1792.           start ("In") or complete ("Out") directory processing at the
  1793.           top of the execution window.  The DOS command shows the
  1794.           expanded substitution variables.
  1795.  
  1796.  
  1797.      Disk {In|Out} : {command}
  1798.  
  1799.           CleanUp displays the DOS command being executed when you
  1800.           start ("In") or complete ("Out") processing a disk at the
  1801.           top of the execution window.  The DOS command shows the
  1802.           expanded substitution variables.
  1803.  
  1804.  
  1805.      Disk {In|Out} : {Command}
  1806.  
  1807.           Written to the Log File when you specify a command to be
  1808.           executed before ("+") or after ("-") processing each disk
  1809.           ("/S{+|-}").
  1810.  
  1811.  
  1812.      Disks : {Disks}
  1813.  
  1814.           Logs the disks processed.  These are the disks listed on the
  1815.           "/D" session switch.
  1816.  
  1817.  
  1818.      Editing Complete
  1819.  
  1820.           Indicates a successful editing session initiated with the
  1821.           "/E" command line switch.
  1822.  
  1823.  
  1824.      Error executing DOS: {result}
  1825.  
  1826.           CleanUp has received an error while trying to execute an
  1827.           external DOS command ("{result}").
  1828.  
  1829.           {result} can be:
  1830.            
  1831.             2  File not found
  1832.             8  Not enough memory (the most common)
  1833.            10  Invalid environment
  1834.            11  Invalid format
  1835.  
  1836.  
  1837.  
  1838.      Exclude: {directory}
  1839.  
  1840.           Entered in the log file when you have specified a
  1841.           {directory} to exclude for processing ("/X").
  1842.  
  1843.  
  1844.  
  1845.  
  1846.      Copyright Bob Breedlove 1989,90               All rights reserved
  1847.  
  1848.  
  1849.  
  1850.  
  1851.      CleanUp Version 2.00      Jan 27, 1990                    Page 29
  1852.  
  1853.  
  1854.  
  1855.      Excluded: {Directory}
  1856.  
  1857.           CleanUp logs the name of any directory which you have
  1858.           excluded from processing.
  1859.  
  1860.  
  1861.      Filename deleted
  1862.  
  1863.           CleanUp has successfully deleted the indicated file.
  1864.  
  1865.  
  1866.      Filename not deleted/processed
  1867.  
  1868.           This message is displayed on the screen and recorded in the
  1869.           log file.  You specified the verify parameter ("/V") and
  1870.           answered "N" (no) to the prompt.
  1871.  
  1872.  
  1873.      Filename unable to delete
  1874.  
  1875.           CleanUp was not able to delete a file which matched one of
  1876.           the patterns.  This can be caused by read-only file
  1877.           attributes or share locking in a network environment.
  1878.  
  1879.  
  1880.      Finding Directories
  1881.      Please wait . . .
  1882.  
  1883.           Displayed while CleanUp is reading all directories on the
  1884.           disk.  CleanUp first scans each disk for all directories
  1885.           then processes them from an internal list.
  1886.  
  1887.  
  1888.      Loading Control File.
  1889.      Please wait . . .
  1890.  
  1891.           Displayed in the message area while CleanUp is loading the
  1892.           control file.
  1893.  
  1894.  
  1895.      PROCESSING COMPLETE
  1896.      Press ANY key . . .
  1897.  
  1898.           Displayed in the {message area} when CleanUp has completed
  1899.           processing unless the "/B" system switch has been entered. 
  1900.           CleanUp pauses until you press any key.
  1901.  
  1902.  
  1903.      Processing {Filename} : {command}
  1904.  
  1905.           CleanUp displays the DOS command being executed at the top
  1906.           of the execution window when you have specified a command to
  1907.           be run rather than deleting a file.  The DOS command shows
  1908.           the expanded substitution variables.
  1909.  
  1910.  
  1911.  
  1912.      Copyright Bob Breedlove 1989,90               All rights reserved
  1913.  
  1914.  
  1915.  
  1916.  
  1917.      CleanUp Version 2.00      Jan 27, 1990                    Page 30
  1918.  
  1919.  
  1920.  
  1921.      Processing,
  1922.      Please wait . . .
  1923.  
  1924.           Message displayed in the {messages and prompts} area of the
  1925.           CleanUp screen during processing.
  1926.  
  1927.  
  1928.      Program aborted by operator!
  1929.  
  1930.           Message is displayed if you abort program operation by
  1931.           pressing any key and then answering "Y" to the "Abort
  1932.           Operation" prompt.
  1933.  
  1934.  
  1935.      Unable to access : {Root Directory}
  1936.  
  1937.           CleanUp is unable to access the specified root directory. 
  1938.           Because CleanUp cannot process the root directory, it is
  1939.           unable to process the entire disk.
  1940.  
  1941.  
  1942.      Unable to change to {Directory}
  1943.  
  1944.           While processing, CleanUp was unable to change to the
  1945.           indicated directory ("cd {directory}").  This is considered
  1946.           a fatal error since CleanUp WAS able to change to the
  1947.           directory to place it on the working list.  This error may
  1948.           be caused by directory "locking" in a multi-tasking or
  1949.           network environment.  CleanUp must have access to all
  1950.           directories you have asked it to process.
  1951.  
  1952.  
  1953.      Unable to create command window
  1954.  
  1955.           CleanUp attempted to create a window in which to run an
  1956.           external command but was unable to do so.  This is usually
  1957.           caused by too little memory.  Try removing one or more TSR
  1958.           program from memory and start CleanUp again.
  1959.  
  1960.  
  1961.      Unable to create edit window
  1962.  
  1963.           While trying to edit the control file, CleanUp was unable to
  1964.           create the edit window.  This is usually an indication of
  1965.           too little available memory.
  1966.  
  1967.  
  1968.      Unable to display edit window
  1969.  
  1970.           While trying to edit the control file, CleanUp was unable to
  1971.           display the edit window.  This is usually an indication of
  1972.           too little available memory.
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.      Copyright Bob Breedlove 1989,90               All rights reserved
  1979.  
  1980.  
  1981.  
  1982.  
  1983.      CleanUp Version 2.00      Jan 27, 1990                    Page 31
  1984.  
  1985.  
  1986.  
  1987.      Unable to execute external command for {Heading}
  1988.  
  1989.           CleanUp was unable to create the window and execute a
  1990.           command for the {heading} process.  Heading will contain the
  1991.           name of the process ("Disk In", "Directory In", etc.) and
  1992.           the command that it was trying to execute.  This abort
  1993.           message is usually indicative of too little memory.
  1994.  
  1995.  
  1996.      Unable to initialize editor
  1997.  
  1998.           CleanUp was unable to initialize the edit buffers to edit
  1999.           the control file.  This is usually an indication that you do
  2000.           not have enough free memory.
  2001.  
  2002.  
  2003.      Unable to open LogFile
  2004.  
  2005.           CleanUp was unable to open the log file.  CleanUp attempts
  2006.           to place the log file in the same sub-directory as the
  2007.           control file.  Be sure that this is NOT a protected
  2008.           directory.
  2009.  
  2010.  
  2011.      Unable to save {ControlFileName}
  2012.  
  2013.           CleanUp was unable to save the control file after you edited
  2014.           it.  This is usually a result of removing a diskette on
  2015.           which the file was located or some action taken over a
  2016.           network.
  2017.  
  2018.  
  2019.      {ControlFileName} too large to edit!
  2020.  
  2021.           The control file is larger than 64K.  This is highly
  2022.           unlikely with CleanUp's control file.  You are probably
  2023.           pointing to a file which is NOT a CleanUp control file.
  2024.  
  2025.  
  2026.      {Filename} processed
  2027.  
  2028.           CleanUp displays this message when it has completed
  2029.           processing a file for which you have specified a DOS
  2030.           command.  If required, it will also log the message to the
  2031.           log file.
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.      Copyright Bob Breedlove 1989,90               All rights reserved
  2045.  
  2046.  
  2047.  
  2048.  
  2049.      CleanUp Version 2.00      Jan 27, 1990                    Page 32
  2050.  
  2051.  
  2052.  
  2053.      15  Registration Form
  2054.  
  2055.      To register CleanUp, send $5.00 and this completed registration
  2056.      form to:
  2057.  
  2058.           Bob Breedlove
  2059.           3196 Swallowsnest Dr.
  2060.           Sacramento, CA 95833
  2061.  
  2062.      You will receive confirmation of your registration and support
  2063.      instructions by return mail.  When the new version of CleanUp is
  2064.      released, you will receive if FREE OF CHARGE!  Thanks for
  2065.      registering CleanUp.
  2066.  
  2067.      Name:     __________________________________________________
  2068.  
  2069.      Address:  __________________________________________________
  2070.  
  2071.                __________________________________________________
  2072.  
  2073.      City:     ___________________________ State: ___ Zip: ______
  2074.  
  2075.      Phone:    (______) _____-_______ extension _________________
  2076.  
  2077.      The following information is optional, however, it will help me
  2078.      provide you with assistance should you need support to use
  2079.      CleanUp.
  2080.  
  2081.      Computer: __________________________________________________
  2082.  
  2083.      Type:     808X____  80286____  80386____  Other_____________
  2084.  
  2085.      Memory:   ___________________
  2086.  
  2087.      Graphics: CGA__ VGA__ EGA__ B/W__ Hercules__
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.      Copyright Bob Breedlove 1989,90               All rights reserved
  2111.  
  2112.  
  2113.